CSS3Buttons 技术文档

1. 安装指南

首先，确保您使用的 Rails 版本为 3.1 或更高版本。在您的 Rails 项目的 Gemfile 中添加以下代码：

gem 'css3buttons'

然后，运行以下命令安装 Gem：

bundle install

对于 Rails 3.0.x 版本，您需要指定安装 0.9.5 版本的 Gem：

gem 'css3buttons', '0.9.5'

2. 项目的使用说明

在 Rails 3.1 中使用

在 app/assets/stylesheets/application.css 文件中引入样式表：

*= require css3buttons
*= require_self

默认情况下，css3buttons 包含了一个重置样式表。如果不需要，可以使用以下代码引入：

*= require css3buttons/without-reset
*= require_self

在 Rails 3.0.x 中使用

运行以下命令生成样式表和图标/按钮图片：

rails g css3buttons

在您的布局文件中添加以下代码：

<%= css3buttons_stylesheets %>

如果想要使用自定义的重置样式，可以：

<%= css3buttons_stylesheets :include_reset => false %>

3. 项目API使用文档

使用 button_link_to 方法替换 link_to 来创建按钮。此助手方法接受与 link_to 相同的参数：

<%= button_link_to "Search", search_path %>

图标

您可以通过在助手方法前加上图标名称来添加图标：

<%= magnifier_button_link_to "Search", search_path %>
<%= user_button_link_to "Account", edit_current_user_path %>

样式

可以使用 primary、big 和 pill 选项来添加样式：

<%= primary_button_link_to "Home", root_path %>
<%= pill_button_link_to "Archive", archive_path %>

颜色

通过在方法前加上 positive 或 negative 来添加颜色：

<%= negative_trash_button_link_to "Delete", delete_path %>
<%= positive_pill_reload_button_link_to "Reload", reload_path %>

还可以使用 `danger和safe作为替代。

按钮组

使用 button_group 方法将按钮组合在一起：

<%= button_group do %>
  <%= button_link_to "Show", @post %>
  <%= button_link_to "Edit", edit_post_path(@post) %>
<% end %>

表单按钮

对于表单按钮，使用 button_submit_tag 方法：

<%= positive_button_submit_tag "Publish" %>

注意：<submit> 标签不支持图标，如果需要在表单中包含图标，请使用 button_tag 方法。

4. 项目安装方式

请参考上述的安装指南部分，根据您的 Rails 版本在 Gemfile 中添加相应的 Gem 代码，然后运行 bundle install 命令。