tiddlywebplugins.form 0.12.1

tiddlywebplugins.form

提供一个序列化器，将HTML表单数据转换为可以放入存储的对象。

还向标准URL集添加POST支持，并支持上传二进制文件。

支持POST的URL包括

/bags/foo/tiddlers /recipes/foo/tiddlers

要使用，请将tiddlywebplugins.form添加到tiddlywebconfig.py中的system_plugins。

然后您可以将tiddler POST到服务器，如下所示

1. 设置一个HTML表单，包含任何命名元素。支持的名字包括

   title - tiddler.title（这是可选的，取决于您POST到哪个URL。另外，如果您没有标题而POST到/bags/foo/tiddlers，您将得到一个UUID标题）。text - tiddler.text tags - tiddler.tags（这可以是一个列表（例如复选框），或者一个格式化成标准TiddlyWiki标签的字符串）。created - tiddler.created modified - tiddler.modified file - 这是一个特殊情况，代表一个二进制文件，所以必须采用HTML <input type="file" /> 标签的形式。如果指定了此内容，您可以包括标签和标题，但其他内容将被忽略。

2. 表单的内容类型（HTML表单中的enctype属性）必须是application/x-www-form-urlencoded或multipart/form-data（如果上传二进制文件）

3. 将表单POST到上述URL之一（即设置action属性），所需时替换foo。

4. 可选地指定一个重定向，以便重定向到不同的页面。

示例用法

假设您想将一个新的tiddler POST到“common”包，您可能包括以下HTML

<form action=”/bags/common/tiddlers” method=”POST”> <input type=”text” name=”title” value=”新条目” /> <textarea name=”text” rows=”5” cols=”40”></textarea> <input type=”text” name=”tags” /> <input type=”submit” value=”保存” /> </form>

或者，您可能想将二进制文件上传到“common”包

<form action=”/bags/common/tiddlers” method=”POST” enctype=”multipart/form-data”> <input type=”file” name=”file” /> <input type=”submit” value=”上传” /> </form>

还有一个专门为TiddlyWiki设计的二进制上传插件，用于与tiddlyweplugins.form一起使用。您可以在https://raw.githubusercontent.com/TiddlySpace/tiddlyspace/master/src/plugins/BinaryUploadPlugin.js找到它

源代码可以在https://github.com/tiddlyweb/tiddlywebplugins.form找到