jonom / silverstripe-text-target-length
在 SilverStripe 文本表单字段上设置字符长度推荐
2.0.3
2023-06-17 22:58 UTC
Requires
- silverstripe/framework: ^4.0 || ^5.0
README
如果您看到标记为“描述”的字段,您就大致知道应该放入什么类型的内容。但您如何知道应该写多少呢?一句简短的话可能就足够了,但也许需要一个段落或更多?一个优秀的内容计划应该为每种内容推荐一个理想长度,这样内容作者和设计师都可以做出明智的决定。
此模块扩展了 Silverstripe 中的 TextField
、TextareaField
和 HTMLEditorField
类,允许您设置推荐内容长度,并设置字符计数上的软上限和下限。
要求
Silverstripe 4|5 (3.1+ 在之前的版本中)
安装
composer require jonom/silverstripe-text-target-length
如何使用
安装此模块后,您可以在 TextField
、TextareaField
和 HTMLEditorField
表单字段上调用 setTargetLength()
。
// Ideal length: 100 characters // Minimum: 75 (automatically set at 75% of ideal) // Maximum: 125 (automatically set at 125% of ideal) $field->setTargetLength(100); // Ideal length: 100 characters // Minimum: 25 // Maximum: 150 $field->setTargetLength(100, 25, 150); // Prefer to think in word count? // 6 characters per word works okay for English $field->setTargetLength(50*6);
自定义提示文本
此模块支持通过 yml 进行翻译,因此如果您想更改用户键入时显示的提示文本,只需创建自己的语言文件来覆盖模块中包含的文件即可。
前端使用
如果您想在 CMS 之外使用此模块,您需要在页面上加载 jQuery 和 jQuery Entwine 的副本。示例
Requirements::javascript('silverstripe/admin:thirdparty/jquery/jquery.js'); Requirements::javascript('silverstripe/admin:thirdparty/jquery-entwine/dist/jquery.entwine-dist.js');
维护者联系方式
赞助
如果您想提高维护者的士气,您可以通过 GitHub 进行小额月捐,或通过 PayPal 进行一次性捐款。❤️ 感谢!
如果您想雇佣维护者开发新功能或讨论其他机会,请随时联系我们。