跳转到主要内容

jQuery插件,用于动态统计文本区域和输入字段的字符数

项目描述

概述

jQuery插件,用于动态统计文本区域和输入字段的Twitter风格字符数。

关于charCount

此插件首先创建一个兄弟元素(它立即添加到表单元素之后),称为“计数器”,其中存储剩余字符信息。在每个keyup事件或文本字段值更改时,计数函数会被触发,并且这个“计数器”元素的内容会相应地更改。如果剩余字符数达到“警告”区域(接近零),则添加CSS类。我们使用此类来更改字符计数信息的颜色。如果计数达到零并超过它,则添加另一个类,以便我们可以为超过限制的样式使用另一种样式。

为了方便您查找,这是插件默认生成的代码

<span class="counter">140</span>

插件选项(及默认值)

limit: 140

您希望为文本区域或输入字段设置的字符限制。它必须是一个数字。

warning: 25

当剩余字符数达到此选项设置的数字时,将应用“警告”CSS类名到计数器元素。

counterElement: ‘span’

您希望选择作为“计数器”元素的类型。默认情况下是一个SPAN元素,但您可以使用段落、div、strong、em等。

css: ‘counter’

添加到计数器元素的类名。使用此类名作为CSS选择器来描述元素的样式。

cssWarning: ‘warning’

一旦字符计数达到“警告”数值,添加到计数器元素的类名。

cssExceeded: ‘exceeded’

一旦字符计数达到零,添加到计数器元素的类名。

counterText: ‘’

如果您希望在剩余字符数之前添加一些文本,可以使用此选项。默认为空。

以下是默认使用代码的示例

$("#message1").charCount();

…以下是一些自定义选项的插件使用示例

$("#message2").charCount({
    allowed: 50,
    warning: 20,
    counterText: 'Characters left: '
});

还可以查看我为我的演示使用的CSS

form .counter{
    position:absolute;
    right:0;
    top:0;
    font-size:20px;
    font-weight:bold;
    color:#ccc;
}
form .warning{color:#600;}
form .exceeded{color:#e00;}

如何安装

此插件可以像其他Plone插件一样安装。请按照官方文档进行操作。

在您的门户上安装该软件包后,您可以在以下位置访问演示:http://youportal.com/++resource++collective.js.charcount.demo.html

有任何想法?发现了一个错误?请通过打开支持工单告诉我们。

大多数无害

https://secure.travis-ci.org/collective/collective.js.charcount.png

安装

  • 当您阅读此内容时,您可能已经运行了easy_install collective.js.charcount。有关安装setuptools(和EasyInstall)的说明,请参阅:http://peak.telecommunity.com/DevCenter/EasyInstall

  • 获取pythonproducts并通过以下方式安装:

    python setup.py install --home /path/to/instance

    到您的Zope实例中。

  • /path/to/instance/etc/package-includes目录中创建一个名为collective.js.charcount-configure.zcml的文件。该文件应只包含以下内容

    <include package="collective.js.charcount" />

或者,如果您正在使用zc.buildout和plone.recipe.zope2instance配方来管理您的项目,您可以这样操作

  • collective.js.charcount添加到要安装的egg列表中,例如

    [buildout]
    ...
    eggs = collective.js.charcount
  • 告诉plone.recipe.zope2instance配方安装一个ZCML别名

    [instance]
    recipe = plone.recipe.zope2instance
    ...
    zcml = collective.js.charcount
  • 重新运行buildout,例如使用

    $ ./bin/buildout

如果您将从另一个包的configure.zcml文件中显式包含包,则可以跳过ZCML别名。

更新配置后,您需要运行“bin/buildout”,这将负责更新您的系统。

转到Plone站点的“站点设置”页面,然后单击“插件”链接。

勾选collective.js.charcount旁边的复选框,然后单击“激活”按钮。

注意:您可能需要清空浏览器缓存并保存资源注册表,才能看到软件包安装的效果。

贡献者

  • Cleber J. Santos

变更日志

1.0(未发布)

  • 初始发布

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

collective.js.charcount-1.1.zip (27.2 kB 查看散列)

支持者