getolympus / olympus-dionysos-field-text
文本字段,此组件是Olympus Dionysos字段的一部分。
Requires (Dev)
- phpunit/phpunit: ~5.3
README
Dionysos 文本字段
此组件是WordPress的 Olympus Dionysos 字段 的一部分。
它使用默认的WordPress文本字段来显示密码、范围、文本、日期时间、电话等字段。
composer require getolympus/olympus-dionysos-field-text
目录
字段初始化 • 变量定义 • 设置定义 • 检索数据 • 发布历史 • 贡献
字段初始化
使用以下行将 文本字段
添加到您的 WordPress 管理页面或自定义文章类型元字段中
return \GetOlympus\Dionysos\Field\Text::build('my_text_field_id', [ 'title' => 'What do you like?', 'default' => 'Penguins, I am sure they\'re gonna dominate the World!', 'description' => 'Put in here everything you want.', 'placeholder' => 'McDonald\'s as well', 'type' => 'text', /** * Settings definition * @see the `Settings definition` section below */ 'settings' => [], ]);
变量定义
接受类型
date
查看 日期类型datetime-local
查看 日期时间本地类型email
查看 电子邮件类型hidden
查看 隐藏类型month
查看 月份类型number
查看 数字类型password
查看 密码类型range
查看 范围类型search
查看 搜索类型tel
查看 电话类型text
查看 文本类型time
查看 时间类型url
查看 URL类型week
查看 周类型
设置定义
settings
变量是一个数组,其选项取决于 type
值。
在所有情况下,以下都是默认设置及其说明
- 特殊情况:
attrs
允许您添加所有必要的附加属性,例如data-*
。 请注意 这一点! after
将在字段后插入内容。在number
和range
的情况下,after
内容将预先添加max
值before
将在字段前插入内容。在number
和range
的情况下,before
内容将附加min
值class
将CSS类添加到已存在的regular-text
字段类(在hidden
情况下不使用)readonly
将避免在值设置为true
时使用字段
日期类型
有关Mozilla日期页的完整文档 Mozilla Date page
日期时间本地类型
请参阅Mozilla Datetime-local页面以获取完整文档。Mozilla Datetime-local页面
邮箱类型
请参阅Mozilla Email页面以获取完整文档。Mozilla Email页面
隐藏类型
请参阅Mozilla Hidden页面以获取完整文档。Mozilla Hidden页面
此特殊的display
变量定义是否隐藏字段需要显示字段值
- 设置为
false
,将显示存储在数据库中的值的位置 - 设置为
true
,将显示存储在数据库中的值的位置以及当前值
月份类型
请参阅Mozilla Month页面以获取完整文档。Mozilla Month页面
数字类型
请参阅Mozilla Number页面以获取完整文档。Mozilla Number页面
密码类型
请参阅Mozilla Password页面以获取完整文档。Mozilla Password页面
范围类型
请参阅Mozilla Range页面以获取完整文档。Mozilla Range页面
此range
类型将显示带有字段值的输入number
HTML标签。
搜索类型
请参阅Mozilla Search页面以获取完整文档。Mozilla Search页面
电话类型
请参阅Mozilla Tel页面以获取完整文档。Mozilla Tel页面
文本类型
请参阅Mozilla Text页面以获取完整文档。Mozilla Text页面
时间类型
请参阅Mozilla Time页面以获取完整文档。Mozilla Time页面
当提供step
变量时,浏览器将在分钟部分旁边添加秒输入区域。max
和min
变量的格式将自动强制转换为hh:mm:ss
。
URL类型
请参阅Mozilla URL页面以获取完整文档。Mozilla URL页面
周类型
请参阅Mozilla Week页面以获取完整文档。Mozilla Week页面
检索数据
使用简单的get_option('my_text_field_id', '')
从数据库中检索您的值(参见WordPress参考)
// Get text from Database $text = get_option('my_text_field_id', ''); // Display text echo $text;
发布历史
贡献
- 将其分叉(https://github.com/GetOlympus/olympus-dionysos-field-text/fork)
- 创建您的功能分支(
git checkout -b feature/fooBar
) - 提交您的更改(
git commit -am 'Add some fooBar'
) - 推送到分支(
git push origin feature/fooBar
) - 创建新的拉取请求
由Achraf Chouk倾力打造 ~ 自长时间以来(c)。